Sets an exception handler for a task.

OSStatus MPSetExceptionHandler (
    MPTaskID task, 
    MPQueueID exceptionQ
);

task

The task to associate with the exception handler.

exceptionQ

The message queue to which an exception message will be sent.

function result

A result code.

DISCUSSION

When an exception handler is set and an exception occurs, the task is suspended and a message is sent to the message queue specified by exceptionQ. The message contains the following information:

• The first 32-bits contain the ID of the task in which the exception occurred.
• The second 32-bits contain the type of exception that occurred. See the header file MachineExceptions.h for a listing of exception types.
• The last 32-bits are set to NULL (reserved for future use).

VERSION NOTES

Introduced with Multiprocessing Services 2.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 2.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/6/2000)